This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.
This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.
| The list of the themes | Global methods by category | Global methods by name | The list of the classes | The list of the controls |
class CFArray | ||||
| class, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: Does nothing. | Mac OS Carbon: Works. | Windows: Does nothing. | ||
|
Function:
A class for a core foundation Array. | ||||
|
Notes:
Subclass of CFObject. If the release property is true, the destructor of this class will release the array reference. From CFArray.h: CFArray implements an ordered, compact container of pointer-sized values. Values are accessed via integer keys (indices), from the range 0 to N-1, where N is the number of values in the array when an operation is performed. The array is said to be "compact" because deleted or inserted values do not leave a gap in the key space -- the values with higher-numbered indices have their indices renumbered lower (or higher, in the case of insertion) so that the set of valid indices is always in the integer range [0, N-1]. Thus, the index to access a particular value in the array may change over time as other values are inserted into or deleted from the array. Arrays come in two flavors, immutable, which cannot have values added to them or removed from them after the array is created, and mutable, to which you can add values or from which remove values. Mutable arrays have two subflavors, fixed-capacity, for which there is a maximum number set at creation time of values which can be put into the array, and variable capacity, which can have an unlimited number of values (or rather, limited only by constraints external to CFArray, like the amount of available memory). Fixed-capacity arrays can be somewhat higher performing, if you can put a definate upper limit on the number of values that might be put into the array. As with all CoreFoundation collection types, arrays maintain hard references on the values you put in them, but the retaining and releasing functions are user-defined callbacks that can actually do whatever the user wants (for example, nothing). Computational Complexity The access time for a value in the array is guaranteed to be at worst O(lg N) for any implementation, current and future, but will often be O(1) (constant time). Linear search operations similarly have a worst case complexity of O(N*lg N), though typically the bounds will be tighter, and so on. Insertion or deletion operations will typically be linear in the number of values in the array, but may be O(N*lg N) clearly in the worst case in some implementations. There are no favored positions within the array for performance; that is, it is not necessarily faster access values with low indices, or to insert or delete values with high indices, or whatever. (© 1999-2002 by Apple Computer, Inc., all rights reserved) | ||||
Clone as CFArray | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> nil. | Mac OS Carbon: Works. | Windows: -> nil. | ||
|
Function:
Creates a new immutable array with the values from the given array. | ||||
|
Notes:
The values itself are not duplicated, but retained. | ||||
ContainsValue(value as CFObject) as boolean | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> nil. | Mac OS Carbon: Works. | Windows: -> nil. | ||
|
Function:
Reports whether or not the value is in the array. | ||||
count as integer | ||||
| property, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> false. | Mac OS Carbon: Works. | Windows: -> false. | ||
|
Function:
Returns the number of values currently in the array. | ||||
CountOfValue(value as CFObject) as integer | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> nil. | Mac OS Carbon: Works. | Windows: -> nil. | ||
|
Function:
Counts the number of times the given value occurs in the array. | ||||
Edit as CFMutableArray | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> nil. | Mac OS Carbon: Works. | Windows: -> nil. | ||
|
Function:
Creates a new mutable array with the values from the current array. | ||||
FirstIndexOfValue(value as CFObject) as integer | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> -1. | Mac OS Carbon: Works. | Windows: -> -1. | ||
|
Function:
Searches the array for the value. | ||||
|
Notes:
Result: The lowest index of the matching values, or -1 if no value matched. | ||||
Item(index as integer) as CFObject | ||||
| method, CoreFoundation | So, 21. Jul 2002 | |||
| Mac OS Classic: -> false. | Mac OS Carbon: Works. | Windows: -> false. | ||
|
Function:
Returns the entry with the given index. | ||||
|
Notes:
Index from 0 to count-1. | ||||
LastIndexOfValue(value as CFObject) as integer | ||||
| method, CoreFoundation | Di, 23. Jul 2002 | |||
| Mac OS Classic: -> -1. | Mac OS Carbon: Works. | Windows: -> -1. | ||
|
Function:
Searches the array for the value. | ||||
|
Notes:
Result: The lowest highest of the matching values, or -1 if no value matched. | ||||
Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.